BOT UX API
Get DetailedBalance
/{businessId}/detailedBalance
[GET]
This operation retrieves detailed balances by using subscriber number.
URL
http://[host]:[port]/bot-ux/v1/{businessId}/detailedBalanceURI Parameter
Note: CWC bu's is actual Implementation
| Name | Type | M/O | Description |
|---|---|---|---|
| businessId | string | M | businessId string M Business unit identifier. Example: "JM",etc., |
Headers
| name | value | description | required |
|---|---|---|---|
| X-Correlation-ID | string | This is a unique identifier for the current call chain that can be used to tie together log entries on multiple layers. Example: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2b | M |
| lob | String | The Line of Business Identifier currently available are: Enum: PREPAID | M |
Security Headers
| Name | Type | M/O | Description |
|---|---|---|---|
| client_id | string | M | Client Id value for Client Id Enforcement policy. Environment Specific Value. Eg: 438837c439924cbca0e96113d9abded0 |
| client_secret | string | M | Client secret value for Client Id Enforcement policy. Environment Specific Value, eg: 8ABb78e206384B33aE08a61f5bDfd393 |
Query Param
| Name | Type | M/O | Description |
|---|---|---|---|
| logicalResource.id | number | M | subscriberNumber/MSISDN |
Possible response success
This section defines all the possible data structures received by the client and that must be considered satisfactory at the time of responding to the method.
TMF Response for getDetailedBalances
Success Response
[
{
"name": "Core",
"description": "primaryBalance",
"isShared": true,
"logicalResource": [
{
"@type": "subscriberNumber",
"id": "18765544355"
}
],
"remainingValue": {
"amount": 0.00,
"units": "JMD"
},
"remainingValueName": "primaryBalance",
"usageType": "Core",
"validFor": {
"endDateTime": "2023-02-11T00:00:00.000-05:00"
},
"status": "active",
"@baseType": "BucketBalance",
"@type": "B",
"ratingState": "2",
"@language": "ENG"
},
{
"name": "internet",
"description": "Mobile Internet",
"isShared": true,
"logicalResource": [
{
"@type": "subscriberNumber",
"id": "18765544355"
}
],
"remainingValue": {
"amount": 68.05,
"units": "GB"
},
"remainingValueName": "Mobile Internet",
"usageType": "Internet",
"validFor": {
"endDateTime": "2023-02-11T00:00:00.000-05:00"
},
"status": "active",
"@baseType": "BucketBalance",
"@type": "B",
"ratingState": "2",
"@language": "ENG"
}
]